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User's Guide 


GMS is a software package designed to operate on the Meta 4A 
with the extensions provided by the Level 0 Extended 
Machine. GMS provides program loading, supervisory 
services, I/O and utility program support. A knowledge of 
the Meta 4 Level 0 Extended Machine is assumed. 1 
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1 INTRODUCTION 


The Graphic Monitor System (GMS) provides supervisory 
services to the BUGS user not provided by the Meta 4A Level 
0 Extended Machine. These services facilitate a number of 
commonly required functions including program storage and 
loading, file manipulation, and input/putput to card reader, 
operator’s console and disk. 


All 
Level 0 
extended 
Readers 
required 


readers are assumed to be familiar with the Meta 4A 
extended machine, including data control and 
instructions, excluding extended I/O instructions, 
planning to perform S/360 or 


to 


including the 


be familiar with Level 
event handling mechanisms. 


0 


Meta 4B 
support 


I/O 

for 


are 

I/O 





The Graphic Monitor System (GMS) is one of a number of 
possible supervisory programs which run on the Meta 4A Level 
0 Extended Machine. GMS provides a framework within which a 
user's programs are loaded and executed. In addition, GMS 
provides a number of utility programs which a user can run 
either from the console or directly from another program. 


2ii_GMS_ENVIE0NMENT 


GMS runs on the Meta 4A Level 0 Extended Machine. 
This machine has a minimum configuration of a Meta 4A 
with 16K bytes of storage, Meta 4A Control Panel, Model 
1444 disk, a console terminal, and Model 3461 Card 
Reader. GMS resides on one or more of 4 supervisor 
program files named GMSNUCn. The version desired is 
indicated by the Control Panel switch setting (bits 14 
and 15) entered during the IPl sequence. 


2 a 2_gms_files_and_svc:s 


2.2.1 GMS FILES 


Data and programs are stored in files on disk. 
These GMS disk files consist of an arbitrary number of 
fixed length records. Files can have records of 
arbitrary length greater than or equal to 16 bytes. 
Each file has associated with it an eight-character 
name and a four-character type. Files are required to 
have unique file name, type pairs. GMS utility names 
and supervisor program names (GMSNUCn) are reserved 
for system use. Only one system defined tile type is 
used - module (MODU). 

GMS programs residing on disk as MODU files can 
be invoked via GMS either from the console or directly 
from a user's program. All GMS utility programs 
reside on separate disk MODU files under their 
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respective names. All user programs which run under 
GMS must be contained ir such a file. For the 
creation of such files see the GMSLINK and CHARON 
manuals or the OFFLINE READ utility in Section 4. 

GMS files can be manipulated via GMS SVC's and 
GMS Utility Programs called either from the console or 
from the user's program. S\C 's are available to read 
or write individual records of a file. Records may be 
randomly read or written ever the whole extent of the 
file. In addition, files may be extended one record 
at a time. Utilities are available to create, merge, 
erase, examine, and alter files. 


2.2.2 GMS SVC'S 


Supervisor calls (SVC's) provide the mechanism 
whereby a user program communicates with GMS. 
Supervisory services available from GMS fall into 
three categories: unit record I/O, disk I/O, and 
program invocation. The unit record equipment 
supported includes the card reader and the terminal 
(console). The disk I/C supports GMS files with a 
single access method for reading and writing random 
fixed-length records. The third category of SVC 
allows the user to call any other program which exists 
as a separate GMS file. The usage of the various GMS 
SVC's is described in the next section. 


2.3_GMS_0FERATI0N 


GMS is IPLed from the Meta 4A Control Panel. Once 
IPLed, GMS will first print out an initial message on the 
current command source and then enter command mode. The 
command source is either the console or the Vector 
General, depending on the setting of the Terminal/VG 
switch (in the Black Box next to the terminal). If the 
switch is left, the terminal is used, if right, the 
Vector General is used. In general, "console" will mean 
the current command source in the discussion below. 

The terminal can also be used as a 1200 baud CP/CMS 
terminal. The lights on the Elack Eox indicate if the 
terminal is in CP/CMS mode or GMS mode. Pressing the 
white button switches from one mode to the other. 
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Messages from the 360 will 
terminal and put the terminal in 
from GMS are not printed unti 
mode. The GMS light will bli 
pending. (Note that a circumflex 
character for 1200 baud.) 


print immediately on the 
to CP/CMS mode. Messages 
1 the terminal is in GMS 
nk if there is a message 
, capital N, is the logon 


In command mode, GMS pri 
waits for entry of a prog 
request consists of a file 
separated by blanks. A carria 
of a request. Null input regu 
program request is entered, 
type MODU (module), is loaded 
parameters. When programs are 
data is returned. When called 
may or may not be returned { 
Section 3). 


nts out a •** character and 
ram request. The program 
tame followed by parameters 
ge return indicates the end 
ests are ignored. When the 
the file, if found and of 
and called with the entered 
called from the console no 
from another program, data 
see description of SVCCA in 


Program and GMS synchronization is achieved by use 
of the WAIT and POST instructions provided by the LEVELO 
Extended Machine. GMS initiates the input command by 
issuing an SVC (SVCCA) and WAITS for notification of 
completion from the called program. The command mode of 
GMS is re-entered when the called program indicates 
completion by POSTing the WCH pointed to by register 2 on 
entry. The called program is deleted when it issues the 
final RETurn instruction. The POST must precede the RET. 
However, the called routine need not immediately issue a 
RET after POSTing GMS. Such a defered RET would allow 
the called program to remain in core during the execution 
of other console-initiated programs. 


2.3.1 COMMAND INPUT FROM THE CONSOLE 


When entering input lines from the typewriter, 
the console edit characters (RUBOUT, LINEFEED) can be 
used to backspace one character or delete the whole 
request line respectively. The BREAK character can be 
used to delete and restore console output. All console 
output will be suppressed after the use of BREAK until 
the next TYPEIN SVC is processed, or BREAK is 
depressed again. 
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2.3.2 COMMAND INPUT FROM TKE VECTOR GENERAL 


When entering input from the Vector General, the 
cursor forward and cursor tackspace provide character 
editting facilities, and the home key acts as a line 
delete. Function keys 0, 1, 8, 9, 10, and 11 are used 

to control the operation cf the Vector General for 
input: 

0 is used to erase the screen. 

1 is used as a toggle. When it is lit, lines will be 
rolled off the screen when more room is needed; 
when it is not lit, the user must press key 0 to 
continue when the screen gets full. 

8 through 11 set the character size to the smallest 
through the largest, respectively. 
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3 GMS SVC'S 


GMS provides a number of services to the user. These 
services are requested by the user program by means of 
supervisor calls. A single Meta 4A instruction. Supervisor 
Call Single-register (SVCS), performs all the setup required 
to issue an SVC. The instruction loads a pointer to the SVC 
parameter list into register 2 and issues the SVC type 
indicated by the second argument: 

SVCS PLIST,SVCNAME 

where PLIST is the label of the SVC parameter list and 
SVCNAME is equated to the SVC number. The macro GMSVCS 
expands into a set of equates for the various SVC numbers 
supported by GMS. 

The parameter list for the SVC provides a communication 
area for passing parameters tc the SVC and storing the 
return code from the SVC and asynchronous control mechanism. 
The first word of the parameter list is always a Wait 
Control Halfword (WCH) . The WCH must be zeroed before 
issuing an SVC pointing at the parameter list containing the 
WCH. When the SVC completes, it posts the WCH and inserts 
the return code in the second byte of the WCH. In order to 
insure that the SVC has completed, the user must issue a 
WAIT instruction with the WCH as the operand. The user will 
not execute the next instruction until the SVC has completed 
and the return code inserted. 

The calling sequences, parameter lists, function, and 
return codes of the GMS SVC*s are described in the following 
sections. Field lengths are in bytes unless otherwise 
specified. 



FINIS 


Function: 

To close a file which was manipulated using either RDBU.F 
and/or WRBUF SVC*s. 


Format: 


PLIST 


SVCS PLIST,FINIS 

• 

DC H'0» WCH 

DC A(FNBT) POINTER TO 

FILETYPE 


FILENAME 


FNFT 




DC 

DC 


CL8•filename' 
CL4 * filetype * 


Usa cje: 

The subject file is removed from the list of active files. 
Any unfinished buffers are written to disk. The directory 
entry for the file is updated if it has been changed. A 
file with pending I/O requests cannot be the subject of a 
FINIS SVC. 


Return Co de: 

Value Meaning 
0 Normal. 

2 File was not active. 

4 File was in use--no action taken. 
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PARSESVC 


F un ction: 

To parse a command line. 


Format: 


SVCD INPUT,L'INPUT,FARSESVC 
B NS NULLINPUT 


or 

SVCD INPUT,0,PARSES VC 
B NS NULLINPUT 


Usa^e: 


The input line is parsed into eight byte fields. The address 
of a getmained area containing the parsed line is returned 
in R3; the user must explicitly free this area when no 
longer needed. If the length is specified as zero, PARSESVC 
will process up to the first carriage return (X'15') in the 
input line; otherwise it will process the length specified. 
If the input line was completely blank, no parsed line will 
be returned, and the condition code will be set to 'NO 
SUCCESS', If successful, the returned line will be in the 
format: 


HEADER 

TEXT 


DC H'Length including header' 

DC H'Number of eight byte fields' 

DC CL8'Command' 

DC CL8'1st operand' 


* 


DC 8X*FF« 
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RDBUF 


Function: 


To read a record from the disk. 


Format: 

SVC s 

• 

PLIST,RDBUF 


PLIST 

• 

DC 

H* 0 * 

WCH 


DC 

A (FNET) 

JOINTER TO FILENAME 

FILETYPE 


DC 

H'record number* DESIRED RECORD NUMBER > 

1 

A(input buffer) POINTER TO INPUT EUFFER 


DC 


DC 

H'record-length* LENGTH CF DATA FIELD TO 




EE READ 


DS 

• 

A 

2H 

RESERVED FOR SYSTEM USE 

FNFT 

• 

DC 

CL8'filename* 

NAME OF FILE TO BE READ 


DC 

CL4'filetype' 

TYPE OF FILE TO BE READ 

Osage: 




The input buffer 

is filled with data from the named disk 

file starting 

at 

the indicated 

record and continuing until 


the length has 


been satisfied. Both 
in this manner. 


partial and multiple 
records can be read in this manner. It should be noted, 
however, that only the starting record number is checked for 
validity. Therefore, users employing multiple record reads 
must insure that all records included in the read exist in 
the file. The STATE SVC can be used to determine the record 


count of a 
the end of 


file on disk. The data read from records beyond 
the file are indeterminate. 


Return Code: 


Value 


Meaning 


0 Normal return. 

2 File net found. 
4 Invalid record 
zero or exceeds 


number, 
records in 


Either 

file. 


eguals 
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RDCARD 


OBSOLETE 


Enact io n: r 

Provide card input facilities to requester. 


format: SVCS PLIST,BDCARD 


WAIT PLIST 


PLIST 

DC 

H 1 0' 

WCH 


DC 

A(EUEEER) 

POINTER TO INPUT EUFFER 


DC 

A (LENGTH) 

LENGTH OF INPUT 


DS 

H 

EESERVED FOR SYSTEM USE 


Usaqe: 


The RDCARD SVC is used to read a 
Requests are processed in the 
received. If an input length 
specified, a read of length 80 is 


card from the card reader, 
order in which they are 
of greater than 80 is 
assumed. 


Return Cede: 

Value Meaning 

0 Normal read completed. 

2 End of file encountered. 
4 Hardware read error. 


t 
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SEGLOAD 


Function: 

Dynamic loading of programs. 


£2SMt: SVCS PLIST,SEGLOAC 


PLIST DC V{PROGRAM NAME) EXTERNAL NAME OF PROGRAM 

WITHIN A SEGMENT 


Usage: 

The SEGLOAD SVC is used to dynamically load the segment 
which contains the given program. The segment can be deleted 
with the SEGDELET SVC. The GMSLINK manual describes how to 
set up program segments. 


Condition Code: 

C2 is 1 load successful cr program already 
in core. 

C2 is 0 load failed; return code will be in 
R 2. 


R etu rn Code: 

Val ue Meaning 

2 Program not fctnd. 

4 Insufficient core to load. 

6 Invalid format. 

8 Loader table overflow; insufficient core, 
10 Invalid parameter. 
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SEGEELET 


Function: 

Dynamic deleting cf programs. 


SVCS PLIS1,SEGDELET 


PLIST DC V{PROGRAM NAME) EXTERNAL NAME OF PROGRAM 

WITHIN A SEGMENT 


Usage: 

The SEGDELET SVC is used to dynamically delete the segment 
which contains the given program. The GMSLINK manual 
describes hew to set up program segments. 


Co ndi tion Code: 

C2 is 1 delete successful cr program not in 
core. 

C2 is 0 delete failed; a return code will 
be in R2. 


Return Code: 

Value Meaning 

10 Invalid parameter. 
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STATE 


Func t ion; 

Provide information about a disk file tc the requester. 


Format; 


SVCS PLIST,STATE 


PLIST EC |]* 0 * 

DC A(FNET) 

DC A(WORKAREA) 


«CH 

POINTER TO FILE 

10INTER TO 26-BYTE WORK 

AREA 


FNFT 

DC 

• 

CL8•filename 1 

, CL 4' 

filetype 

i 

WORKAREA 

• 

DS 

OH 




AFl’FN 

DS 

CL8 

FILE 

NAME 


AFTFT 

DS 

CL4 

FILE 

TYPE 


AFTSECAD 

DS 

H 

EISK 

SECTOR 

ADDRESS OF FILE 

AFTRF.CLN 

DS 

H 

FILE 

RECORD 

LENGTH 

AFTRECCT 

DS 

H 

FILE 

RECORD 

COUNT 

AFTSECCT 

DS 

H 

FILE 

SECTOR 

COUNT 

AFTDATE 

DS 

CL6 

LATE 

LAST CHANGED 


Usaqe; 


The STATE 
information 
represents 
files which 


SVC returns to the requestor 26 bytes of 
about the indicated file. This information 
the present status of the file on disk. For 
are open, this information may not reflect the 
present RECORD and SECTOR counts and date last changed. To 
insure that the information is correct the user must first 
FINIS an open file before issuing the STATE SVC. If a 
WORKAREA pointer of ZERO is used, no data is returned. 


Return Code; 


Value 


Meaning 


0 File found. 

2 File net found. 
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SVCCA 


Function: 


To allow the user to 
program files directly 


invoice GMS utility 
from a program 


programs or other 


Format: 



SVCS 

• 

• 

• 

PLIST,SVCCA 

PLIST 

DC 

H' 0 * 


DC 

A (PROGRAM) 


DC 

• 

• 

• 

A(RETURN) 

PROGRAM 

EC 

CL8*program f 


DC 

CL8 1 argument 1 


DC 

« 

• 

• 

CL8 *arguroent2 


DC 

CL8* argumentn 


DC 

8X 1 FF’ 


KCH 

POINTER 

TO 

PROGRAM 

CALL 

AREA 

POINTER 

TC 

RETURN 

DATA 

STORAGE 

AREA 

OR ZERO 



ile name* PROGRAM FILE NAME 
CR GMS UTILITY NAME 


FENCE INDICATING END OF 
PARAMETERS 


U sa ge: 


The SVCCA SVC is used to invoke external programs which 
reside cn disk as separate files. GMS conventions exist for 
calling GMS utilities and receiving data returned from them. 
Calling another program (including GMS utility programs) 
using a return pointer of zero carses the program to operate 
as if it had been initiated via the console with the same 
arguments. Should a non-zero return area pointer be 
supplied, data is returned in the return area. In the case 
of GMS utility programs the data returnd includes data that 
would otherwise have been printed cn the console. The user 
should consult the subject program source code to determine 
the order and format of the data returned. 






The format example demonstrates the format and manner in 
which parameters are passed to programs invoked from the 
console. When GMS utility programs are called from a user’s 


program, the 
required. If 
question, the 
LCACMOD plus X 


same 
SVCCA was 
WCH will he 

• 100 *. 


parameter 
unable 
posted 


passing 
to load 
with the 


conventions are 
the routine in 
return code from 


TIMEKAIT 


Fu nc tion: 

Provide time interval wait facilities fcr the user. 


Format: 

SVCS 

• 

PLIST,TIMEWAIT 



PLIST 

* 

DC 

DC 

H* 0' 

H * Time 

WCH 

Interval in 

1/100 Seconds' 



DS 

4H 

BESEBVED FOB SYSTEM 

USE 

Usage: 

The TIMEWAIT SVC 

is used 

to set a 

time interval. 

The WCH 

will be 
expired. 

posted 

with a 

code of 

0 when the interval is 
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TCANCEL 


F un ct io n: 

Provide time interval control facilities for the user. 


I°£ISat: SVCS PL 1ST ,TCANCEL 


PLIST 

• 

DC 

H * 0 1 

WCH 


DC 

H'Interval * 



DS 

H 

TIME REMAINING IN INTERVAL 
WHEN CANCELED 


DS 

3H 

RESERVED .FOR SYSTEM USE 


Usage: 


The TCANCEL superviso 
interval. PLIST mus 
TIMEWAIT supervisor, 
will be set to the 
was canceled, and th 
2. If the interval 
returned, and the WCH 


r call is used tc cancel 
t be te parameter list 
The third word of the 
time remaining in the in 
e WCH posted with a comp 
was not active, the ti 
will not be posted. 


an active time 
passed to the 
parameter list 
terval when it 
letion code of 
me will not be 
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TYPEIN 


Function: 

Provide console input facilities to the user, 


Format; 


SVCS PLIST,TYPEIN 


WAIT 


PLIST 


PLIST 


DC 

DC 

DC 

DC 

DS 

DC 

DS 


H' 0' 

A(EUIFER) 
H* LENGTH * 
H* count' 


CL 1 
CL 1 • E 
2H 


or N * 


WCH 

ECINTER TO INPUT BUFFER 
MAXIMUM LENGTH OF INPUT 
NUMBER OF CHARACTERS READ 
EXCLUDING RETURN 
START OF LINE CHARCTER 
£ FOR EDIT, N FOR NO EDIT 
RESERVED FOR SYSTEM USE 


Usage; 

The TYPEIN SVC is used to read cue logical record from the 
console. This record begins with the first character the 
user enters after the start cf line character has been 
printed and ends with the return character. The start of 
line character is used to identify the task reguesting 
input. The GMS command dispatcher uses the * character to 
indicate that a command input is reguested. Logical 
backspace and line delete characters indicate editing 
in the EDIT mode and are treated as regular input 
in the NO-EDIT mode. TYPEIN and TYPEOUT SVC's are 
in the order received. The execution of a 

following a TYPEOUT 


functions 
charcters 
performed 

particular TYPEIN request immediately 
request can be achieved by using the 
TYPEOUT SVC. 


REPLY option of the 
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TYPEOUT 


Function: 

Provide console output facilities to the user, 


Format: 


SVCS PL1ST,TYPEOUT 


WAIT PLIST 


PLIST DC H 1 0 * 

DC A(BUfFER) 

DC H'LENGTH’ 

DC CLI'E or N» 
DC CLI'R or N' 
DC A(TYPEIN) 

DS 2H 


WCH 

EGINTER TO OUTPUT BUFFER 
LENGTH OF OUTPUT BUFFER 
E FOR EDIT, N FOR NO EDIT 
E FOR REPLY, N FOR NO REPLY 
ECINTER TO TYPEIN REQUEST 
IF REPLY, UNUSED OTHERWISE 
EESERVED FOR SYSTEM USE 


U sa ge: 

The TYPEOUT SVC is used to write one logical record to the 
console. The record contained in the output buffer of the 
indicated length is output to the console. In the EDIT mode 
trailing blanks are omitted and a carriage return 
automatically issued. In the Nc-Edit mode the buffer is 
output to the console as is. A single output request is 
issued in the NO-REPLY mode. To cause a given TYPEIN SVC to 
follow immediately a particular TYPEOUT SVC, the REPLY 
option of the TYPEOUT SVC is used. When specified, the 
TYPEIN pointer points to a TYPEIN PLIST. The input 
requested by the TYPEIN PLIST immediately follows the output 
requested by the TYPEOUT PLIST. 
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WRBUF 


Function: 

To write a record to a file on disk. 


Format: 


PLIST 


FN FT 


SVCS PL 1ST * WRBUF 


• 

• 

• 

DC 

DC 

H'O ' 

A(FN FT) 

WCH 

POINTER 

TO FILENAME 

DC 

H•record 

FILETYPE 
number* RECORD 

NUMBER TO BE 

DC 

A(output 

WRITTEN >1 
buffer) POINTER 

TO OUTPUT 

DS 

3H 

RECORD 

RESERVED FOR SYSTEM USE 




• 

DC 

CL8'filename * 

NAME OF FILE 



DC 

CL4 * filetype * 

TYPE OF FILE 



DC 

H*record length' RECORD LENGTH USED 

ONLY 



WHEN CREATING 

FILE 

BY 



WRITING 1ST 

TIME. 

RECORD 

1ST 


U sa ge: 


The indicated record of the named file is written out. If 
the indicated record exists, it is replaced by the new copy. 
If the record number does not exist, and it exceeds by 1 the 
present record count, the file is extended by this one 
record. When the file is created by the first WRBUF SVC, 
the record number specified must be 1. During the creation 
of the file, the record length field must be valid and 
exceed 15 bytes in length. The record length specified is 
used as the record length for all subsequent WRBUF's to this 
file. 
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Re tu rn Co de : 


Value 

Meaning 



0 

Normal return. 


2 

File net found. 


4 

Invalid record number - 
large. 

either 0 or too 

6 

Insufficient contiguous 
PACK utility. 

disk space - see 


-21 





4 GMS UTILITIES 


GMS provides a number of utility programs. These 
utility programs, invokable from the operator's console or 
directly front a user's program, provide commonly used 
functions including file creation, manipulation, status 
monitoring, and dumping as well as system housekeeping and 
monitoring. These utilities can be invoked directly from 
the console by typing in the utility name followed by the 
required parameters separated by one or more blanks. These 
utilities also can be invoked directly from a user's program 
via the SVCCA SVC. The caliinq conventions for use of SVCCA 
are described in Section 3. The operation, parameters, and 
error messages of the GMS utilities are described in the 
following sections. 


The general 
as follows: 

form of the console input for GMS utilities is 

| OPERATION 

i_ _ _ 

* -- 

<OPEB ANDS> j 

The symbols 
document are 

used to represent console inputs in this 
described below: 

UPPERCASE 

Information given in capitals must be typed as 
shown although it may be entered in either 
upper or lower case. 

lower case 

Lowercase information designates the contents 
of a field and does not in itself constitute 
meaningful input. 

< ) 

Parentheses must be typed as shown when any of 
the information appearing within them is 
specified. 

< > 

Brackets indicate information which may be 
omitted. 

<< >> 

Nested brackets indicate items which, if 

specified, must appear in the order shown. 
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Ellipsis indicates that the preceeding item 
may be repeated more than once. 


Underlining indicates the value which 
assumed if none is specified. 


is 
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r 


ALTER 


Function: 


The ALTER utility is used to modify the filename and/or 
filetype of an indicated file. 


Format: 


| ALTER oldfn oldft newfn <newft> 

i . .. . . 

1 

J 

oldfn 

present 

name of file 


oldft 

present 

file type 


newfn 

name to 

which file is to be 

changed 

newf t 

type to which file is to 
specified, the old filetype 

be changed. If not 
is assumed. 

Usacje: 




The name and or type of a file may be changed. This utility 
is especially helpful in maintaining programs by allowing 
new versions of programs to be manipulated and tested while 
old versions exist under another name. 


Error Mes sa ges: 

FILE NOT FOUND. The specified file was not found in the 
directory. 

NEW NAME ALREADY EXISTS. A file by the new name already 
exists. The utility will not run cntil the desired new name 
does not exist in the directory. 

INVALID ARGUMENT (S). Improper input. 
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Return C od e; 


Value Me an ing 
0 Normal 

2 Invalid argument (s). 

4 File net found. 

6 New name already exists. 
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COMBINE 


Funct io n: 

The COMBINE utility allows the user to combine *n' old files 
into one new one. 


Format: 


J COMBINE newfn newft <oldfn cldft> . . 

i_ 


I 

. j 


newfn 

newft 

oldfn 


name to be given to file created by the 
CCMEINE directive 

type of file created by the COMBINE directive 

each file specified by the filename filetype 
pair must have equal record lengths. 


Usage: 

The COMBINE directive creates a new file by concatenating 
the old files specified in the order specified. The new file 
must not already exist as a disk file. 


Error Messages: 

INVALID ABGUMENTS(S). Improper number of arguments 
specified. 


NEW FILE ALREADY 

EXIS1S. 

The 

exists. 

No action 

taken. 


RECORD 

IENGTH INCOM 

PATIBLE. 

The 

record 

lengths. 




NOT FOUND. Old file not found. New file closed containing 
old files in list to this point. 

DISK FULL - PACK! Insufficient contiguous disk storage. 
See PACK directive. 
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DELETE 


Function: 


The DELETE utility allows the cser to remove from core a 
program previously loaded with LOAEMOD or SEGLOAD. 

Format: 

i i 

I DELETE filename | 

L -1 

filename name of program to fce deleted. 

Usage: 

The program and all segments associated with it (see the 
GMSLINK manual for a description of segments) will be 
deleted from the load list and its program memory freed if 
its load count goes to zero. 
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ERASE 


F un ction: 

The ERASE utility is used to delete a given tile from the 
disk. 

Format: 


| ERASE filename filetype 

filename name cf file to be deleted, 

filetype type of file to be deleted. 


Usa ge: 

The named file is deleted from the disk. 

Error Messages: 

FILE IN USE, The indicated file is in use presently and 
therefore cannct be deleted. 

FILE NOT FOUND. The indicated file was not found or was 
found to be the object cf an ERASE already in progress. 

Pet urn C ode : 

Value Mea ni ng 

0 Normal 
2 File in use. 

4 File net found. 
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EXEC 


Function: 

The EXEC command is used to stack a command list from disk 
for execution by GMS. 

F orma t: 


r- - 

| EXEC filename Coperand ,..> J 


filename name of EXEC file {filetype EXEC) 

operand ... symbolic operands 


U sa ge: 

The EXEC file is read into core, with symbolic substitutions 
made for operands. The substituted command list is then 
queued for execution by GMS, with prompting done for prompt 
operands at execution time. 


Error Messages: 


filename EXEC NOT FOUND. The specified EXEC file was not 
found in the directory. 

NO NAME SPECIFIED. There was no EXEC file specified. 

filename EXEC I/O ERROR. There was an I/O error reading the 
EXEC file. 

filename EXEC INVALID SYMEOL CRC no. An invalid symbol was 
encountered in card "no." of the specified EXEC file. 

filename EXEC INVALID IF STATE CRD no. An invalid if 
statement was encountered in the specified card of the 
specified file. 

execname EXEC INVALID OPERATOR CRD no. An invalid logical 
operator was encountered in an if statement. 
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execname EXEC INVALID GPERANL CEE no. The value to check 
against the return code was not tumeric. 


Return Co de : 

Value Mea ni ng 

0 Normal 
12 Abnormal 


Command State me nt S ynta x: 

Terminals: 

<nuraber> =: Number between 1 and 12 
<text7> =: 1 to 7 characters 
<text8> =: 1 to 8 characters 
<label> =: -<text7> 

<prompt> =: ?<t.ext7> | <text7>?<text7> 

<operator> =: EQ J NE | GT | IT 1 GE | IE 
<symbolic> =: 6<number> J <text7>S<number> 

<op1> =: RC J <symbclic> S <text8> 

<op2> =: <symbolic> | <text€> 

<freeop> =: <symbolic> | <text8> | <prompt> 

S ta tem en ts: 

<ifstate> =: SIF <op1> <operatcr> <op2> <label> 

<goto> =: SGGTO <label> 

<print> =: SPRINT <op2> | <print> <op2> 

<typeout> =: 6TYPE0UT OFF 
<command> =: <ccmmand> <freecp> 

<rcommand> =: <ifstate> | <gcto> | <print> | <typeout> 
1 <command> 

<lcommand> =: <rcoramand> | <]abel> <fcommand> 


- 30 - 








FUDE 


Function: 

The FUDD command provides the user with an online debugging 
capability. 


Format: 


i-T 

| FUDD | 
k. _ j 

U sa ge: 

The debugger will respond with the message 'FUDD HERE 
and reguest a command. The FUDE subsystem is described in 
detail in the FUDE User's Guide. 
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HERCULES 


Function: 


The HERCULES utility 
the disk directory, 
console after IPL 'ing 
files. 


allows a user to validate and correct 
It should only be invoked from the 
to avoid conflict with presently open 


F or mat: 


r-1 

| HERCULES | 
t _ J 


Usa <je: 

The HERCULES utility reads the entire disk directory into 
core. Any file with leading or inbedded blanks or 
unprintable characters in its name is deleted. The directory 
is then scanned for invalid or conflicting entries. Invalid 
files are deleted and a message printed tc that effect. If 
the allocation for two files conflicts, the user will be 
requested to decide which file should be deleted. The 
updated directory is then written back to the disk. 


X nf cr;rna ti o n,a 1 Me ss a g es: 

PHASE x COMPLETE: i PROCESSED, j KEPT, k DELETED. One or 
more files have been deleted by HERCULES. 

filename filetype DELETED. This message tells the user 
which file has been deleted. 


Action Messages: 


FILES CONFLICT: 

FILENAME TYPE START LENGTH 

1- filename type i j 

2- filename type i* j' 

DELETE 1 OR 2? The user 


END 

k 

k* 

must 


enter *1* or '2' on the 


keyboard and the indicated file will be deleted. 
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LISTF 


Function: 

The LISTF utility allows the user to list on the console 
information about the files on the disk. 

Format: 


r - 

| LISTF 

<filename 

filetype 

< (keywords)» 

—> 

1 

1 

<file* 

file* 

<(key words)>> 

\ 

1 

< * 

* 

< (keywords) >> 

1 

| 

* 

* 

1 

L _ 

— 

— 


keywords 

NAME 

— print 

only file name 



EXEC 

— create 

an exec file 

with 


and filetype EXEC 

EXEC=fn -- create exec file with 
and filetype EXEC 

INFO --print size of file and 
modified 


filename GMS 
filename fn 
date last 


HEAE -- print file leader 

SORT=sortid -- sort files in ascending order 
as specified, sortid is any combination of the 
following: 

N -- sort by filename and type 
T -- sort by filetype 
S -- sort by filesize 
P -- sort by position cn disk. 


Usa^e: 

When a LISTF utility request is entered, the filename and 
filetype of all files meeting the request are printed. The 
specification of the filename and type can take three 
alternate forms. The first is the complete specification of 
the indicated field. The second is the partial specification 
of the field immediately followed by a *** character. The 
field is matched by all disk directory entries which begin 
with the given partial specification. The third alternate 
form is the •** character along which is matched by any 
directory entry. A null LISTF request causes a list of all 
files to be printed. 
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Error M essag es: 

FILE NCT FOUND. The utility request file specification was 
not matched by any file in the disk directory. 

INVALID ARGUMENT. An incorrect option was specified. 


Return Code: 


Value Meaning 
0 Normal 

2 Invalid arguneert. 
4 File net found. 
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LCAEMOD 


F un ction: 

The LCAEMOD utility allows a user to load a program from 
disk into core. 

Format: 


I-T 

| LCADMOE filename | 

L-J 

filename name of MCDU file ccntaining the program to be 

loaded. 


O sa ge: 


The root 
core. Tha 
specify i n 
the SEGLC 
routine i 
the GMSLI 


segment of specified program will be loaded into 
t copy will remain until a DELETE command is issued 
g the same name. Other segments may be loaded by 
AD SVC or they may be leaded automatically when a 
n a segment not currently in cere is called. {See 
NK manual for a description of segments.) 


Return Cede: 

Value Uganing 


0 

2 

4 

6 

8 


Normal 

MODU file net feund. 
Insufficient cere to 
Invalid MODU format. 
Loader table cverflo 


load. 

w; insufficient core. 













MODMAP 


Function: 

The MODMAP utility allows a tser to print a map of a 
program. 


Format: 


r- t 

| MODMAP filename <start> | 

filename filename of the program to be mapped. 

start address to be used as the iritial lead point. 


Usage: 

The MODMAP prints out the names of all the external symbols 
and their address relative to the start point. Non-CSECT 
entries will be indented one space. 


Error Messages: 

FILE NOT FOUND. The MCEU file was not found in the disk 
directory. 

Return Code: 


Value Meaning 
0 Normal 

2 File net found. 
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MCDZAP 


Function: 

The MODZAP utility allows a user to permanently change the 

contents of a program file on disk. 

Format: 

I MODZAP filename <csect> ] 

L-- 

followed by any number of lines of 

r ---- 

I address old-contents new-contents 1 

t--j 

or 

i | 

1 address p <hex count> j 

• 2 | 

«■ - - 

filename name of the MODU file to be modified. 

csect CSECT name, if multiple CSECT assembly. If 

not specified, filename is assumed to be CSECT 
name. 

address offset from the start of the CSECT to be 

modified. 

old-contents hex string used to verify old contents of file 
at location to be modified. If the 

verification fails, the update is not 
performed. This field must have an even number 
of characters. Odd length fields are zero 
padded right by one. 

new-contents hex string used to replace the old contents of 
the file at the indicated address. This field 
must have an even number of characters. Odd 
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p 


hex count 


length fields are zero padded right by one. 
The replacement and verification fields must 
be egual in length and not greater than 32 
characters long. 

indicates printout of hex contents at the 
indicated address is desired. 

count of hex digits to be printed. Two is 
assumed if not specified. A value of 0 causes 
a nop. A value exceeding 64 is invalid. 


Usage: 

The file and CSECT thereof to be modified are specified in 
the MCDZAP utility reguest. MODZAP processes all subsequent 
console requests directly. Two MCDZAP requests are 
available: one to display the hex contents at a given 
location and one to verify and replace the contents of a 
given location. Any number of requests will be honored once 
the original MODZAP utility is entered. The utility is 
exited when a null line is input. 


Error Messages: 

FILE NOT FOUND. The filename in the MCDZAP utility 
directive does not exist cn disk. 

CSECT NOT FOUND. The csect field specifies a csect name not 
found in the indicated file. 

INCOMPLETE. A modify or print request was not completed due 
to non-existant text. 

INVALID ARGUMENT(S). Either improper specification of one 
of the modify or print fields or a verification failure. 

ADDRESS NOT IN CSECT. Address given was not in current 
csect. 


Return Code: 


Val ue Meaning 
0 Normal 

2 Invalid argument(s). 
4 File net found, 

6 CSECT not found. 
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OFFLINE I1ST 


Function: 

The OFFLINE LIST utility allows the user to list on the 
console fixed columns of cards read from the card reader. 


Format: 


r-- t 

| 0 LIST <start <end>> \ 

I 1 80 | 

i-j 


start column starting the field tc be printed on the 

console. Column 1 is assumed if not otherwise 
specifed. 

end column ending the field tc be printed on the 

console. Column 80 is assumed if not 
otherwise specified. 


Usage: 

The card reader is prepared by pushing the start and read 
buttons. The utility is then initiated from the console. 
Cards will be read and listed until either the reader is 
stopped manually, or the hopper is empty. 


Error Messages: 

INVALID ABGUMENT(S). Invalid specification of utility name 
or column parameters. 

CARD READ ERROR. Hardware indication of card reader error. 


Return Coda; 

Value Meaning 
0 Normal 

2 Invalid argument(s). 
4 Card read error. 
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OFFLINE BEAD - OBSOLETE 


Function: 


The OFFLINE Bead utility provides 
file of card images from the card 


for the creation of a disk 
reader. 


F or mat: 


| 0 BEAD filename filetype j 

0 BEAD * j 


filename filename of the disk file tc be created, 

filetype file type cf the created file. 


Usage: 

The utility is initiated from the console. The card reader 
is then started and will continue to read until stepped or 
until the hepper is empty. The file specified is created on 
disk. If a file by the same name already exists, it is 
deleted and the new file created. The record length for the 
file is determined by the filetype. Standard GMS filetypes 
assume their default lengths. N<n-standard filetypes cause 
files with record lengths of 80 to be created.If •** is 
specified, OFFLINE expects the cards in the stacker to have 
OFFLINE READ commands on the frent of each file to be read. 
The format of these cards must be: 

OFFLINE BEAD filename filetype 

with exactly one space between each parameter. Each OFFLINE 
REAE card will be printed on the console as it is read. 


Error M e ssages: 

DISK FULL - PACK! Insufficient disk space is available. Use 
PACK utility to recover unavailable space. 

INVALID ARGUMENT (S) . Utility name, filename or filetype in 
errer. 
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CARE READ ERROR. Card reader error cccured. File may exist 
partially completed. 


Return Code: 

Value Meaning 
0 Normal 

2 Invalid argument (s). 
4 Card read error. 

6 Disk full. 






PACK 


Function: 

The PACK utility moves disk files tc available sectors 
closer to the lower sector number portion of the disk. The 
result is an unfragmented disk with all the free sectors 
available in one contiguous area at the end of the disk. 


Format: 


i-^ 

I P_A_C_K | 

L_J 

Usage: 

This utility should only be invoked frcn the console after 
IPL’ing tc avoid conflict with presently open files. 


Error Messages: 

SPURIOUS DIRECTORY ENTRIES: 

FILENAME TYPE ADDRESS. 

Entries listed exhibit inconsistencies between disk file 
directory and disk allocation record; run HERCULES. 


Return Code: 

Value Meaning 
0 Normal 

2 One or more spurious directory entries 
encountered. 
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PRINTF 


Function: 

The PBINTF utility dumps a file ct a portion thereof on the 
console. 


Format: 


r - 


| PRINTF 

1^ 

filename filetype 

<start <end>> 1 

J last | 



filename 

name of file to 

be dumped. 



filetype 

type of file to 

be dumped. 



start 

starting reco 

specified, 1 is 

rd number of dump, 

assumed. 

If 

not 

end 

ending record number of dump. If 

specified the last record is assumed, 
specified, the ending record number must 
be less than starting record number. 

not 

If 

not 


Usa^e: 

The PRINTF utility will dump consecutive records starting 
from the indicated record until the ending record is 
specified or an end of file is encountered. 


Error Me ssages: 

FILE NOT FOUND. The indicated file does not exist. 

INVALID ARGUMENT (S). One of the optional paramenters is in 
error or one of the required parameters is net supplied. 

FILE HAS N RECORDS. The start record number exceeds the 
number of records in the file (N). 


Return Code: 
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Value Meaning 
0 Normal 

2 Invalid argument(s), 
4 File net found. 
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PHI NT FX 


F un ction: 

The PRINTFX utility dumps a portion or all of a given file 
in hexadecimal and the equivalent EBCDIC. 


Format: 


| PRINTFX filename filetype <start <end>> I 
I 1 last | 


filename 

name of the file 

to be 

dumped. 



filetype 

type of the file 

to be 

dumped. 



start 

beginning record number 
supplied, 1 is assumed. 

to be 

dumped. 

If not 

end 

ending record 

number 

to be 

dumped. 

If not 


supplied, the last record in the file is 
assumed. The end record number may not be 
less than the start record number. 


Usage: 

The PRINTFX utility will dump records from a file as 
directed until all the indicated records have been dumped or 
until an end of file is encountered. 


Error Mes sa ges: 

FILE NCT FOUND. The named file dees not exist on disk. 

INVALID ARGUMENT (S). Either one of the first two parameters 
was omitted or one of the optional parameters was 
incorrectly specified. 

FILE HAS N RECORDS. The starting record number exceeds the 
number of records in the file (N). 


Return Code: 


r 
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Value Mea ni ng 
0 Normal 

2 Invalid argument(s). 
4 File net found. 














QUERY 


Function: 

The QUERY utility allows the user to obtain the date, the 
number or names of parallel tasks executing, modules loaded, 
files active, or the free memory available. 


Format: 


- - 1 


1 

DATE 

1 

I 

FILES 

1 

J QUERY 

PARALLEL <mode> | 

1 

MEMORY 

1 

1 

MODULES 

1 

L _ - 


- J 

DATE 

indicates 

the date is desired 

FILES 

indicates 
desired.. 

that the number of open files is 

PARALLEL 

indicates 

executing 

that the number of parallel tasks 
is desired. 

MEMORY 

indicates 
is desired 

that the free memory space available 

• 

MODULES 

indicates 
loaded is 

that the number cf modules currently 
desired. 

mode 

if specified, indicates that the names rather 
than the numbers are required for FILES, 
PARALLEL, and MODULES. 


Usage: 

The response to the request is output on the console. 


Error Messages: 

INVALID ARGUMENT. The subfunction was specified 
incorrectly. 
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Return Cede 


Valu e Heanincj 
0 Normal. 

2 Invalid argument. 
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SET 


Function: 

The SET utility allows the user to change the date, logical 
backspace and logical delete characters. 


F orm at: 


- - 

1 SET DATE mm/dd/yy J 

*--j 

- -- 

| SET BACKSPACE char | 

«.-j 

r - - 

j SET DELETE char | 

t-j 

mm/dd/yy standard representation of date. 


a single console character to be used as 
specified. 


Error Messages; 

INVALID ARGUMENT(S). Error in subfunction specification, 
date specification or logical character net specified. 

R et urn Code: 

Value Meaning 
0 Normal. 

2 Invalid argument. 
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SLCAD 


Function: 

The SLOAE utility is used to load SIMALE text pages from a 
disk file into main memory, build a page table for the 
SIMALE, and copy the page table ard one selected text record 
into M4B local storage. 


Format: 


r- 

| SIOAD filename label | 

I pagenumber | 

L-- 


filename 


name of the SIMO file to be loaded. 

\ 


label 


label or entry point name in text record to be 
copied to M4B local storage. 


pagenumber 


decimal number between 
indicating page number 
local storage. 


0 and 31 inclusive 
to be copied to M4B 


Usage: 

When an SLOAD utility is entered, the SIMALE text pages in 
the filename with filetype of SIMO are loaded into main 
memory allocated in one page blocks (256 bytes). Once all 
text pages are loaded, the selection field is used to select 
the text, page to be copied tc M4B local storage (128 
halfwords starting at local storace address 128). If a label 
is specified, the symbol table is accessed to find the 
corresponding page number. If a decimal number is specified, 
it is used as the page number. Note that by GMSconvention 
the label field can be at most 8 characters long. 


Error Messages: 

Improper parameter specification. Too few parameters were 
specified. 

filename SIMO NCI FOUND. Specified file was net. found. 
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filename SIMO NOT WEIL FORMED. Specified file is internally 
inccnsistant. 

filename SIMG - INSUFFICIENT FREE STORAGE. There were no 256 
byte blocks left in main memory. 

INVALID LOCAL STORAGE PAGE SELECTION. If a label was 
specified, it was not fcund in the symbol table or it was 
neither a label nor an entry point. If a page number was 
specified, it was either out of range (0 < page number < 31) 
or the indicated page did not have a corresponding text page 
in the file. 

DISK I/O ERROR. Eisk i/o error occurred during the reading 
of the specified file. 

MULTIPAC NOT AVAILABLE. Multipac net available. 


Return Code: 


Value Meani ng 

0 Normal 
2 Normal 

4 Improper parameter specification 
6 File net found 
8 Nsufficient free storage 
10 Invalid local storage page selection 
12 Disk i/o error 
14 Multipac not available 
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STATISTICS 


Function: 

The STATISTICS utility provides the user with a report of 
the present status of the disk. 

Format: 


r- 

| STATS 

t_ 



Usage: 

When invoked, the statistics utility produces the following 
output: 

i FILES OCCUPYING j SECTCBS; k SECTORS FREE (1% FULL) 
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